Skip to content

feat: 增强每日用量工具洞察#43

Open
kts-kris wants to merge 1 commit into
BigPizzaV3:mainfrom
kts-kris:feat/daily-token-usage-tool-insights
Open

feat: 增强每日用量工具洞察#43
kts-kris wants to merge 1 commit into
BigPizzaV3:mainfrom
kts-kris:feat/daily-token-usage-tool-insights

Conversation

@kts-kris

@kts-kris kts-kris commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

用户价值

这次更新让 Codex Daily Token Usage 不只是一个 Token 计数器,而是更接近一份每日工作用量报告。

用户现在可以看清楚:今天的 Token 消耗主要来自普通对话,还是来自工具辅助工作。它可以帮助回答这些实际问题:

  • 今天 Token 为什么涨得多?
  • 用量主要来自模型对话、命令执行、MCP / 插件调用,还是混合使用?
  • 今天最常用的是哪个工具?
  • 工具调用相对于总 Token 的密度高不高?
  • 当工具事件能和 Token turn 关联时,这部分工具辅助工作大概带来了多少 Token 和成本?

分享图也更适合用于汇报:现在不只展示 Token 总量和预估成本,也展示了这些用量背后的工作方式。

改动内容

  • 增强工具调用采集:
    • 解析应用暴露出的真实 function_call payload;
    • 识别 mcp__server__tool 这类 MCP 工具名称;
    • 增加 DOM 兜底,覆盖当前页面可见的 Codex 工具卡片,例如 exec_command
  • 详情页新增工具洞察指标:
    • 工具总调用次数;
    • 可识别的工具辅助请求数;
    • 工具调用率;
    • 每 10 万 Token 的工具调用密度;
    • 能关联到 Token turn 时展示关联用量;
    • Top 工具。
  • 分享图新增独立的“工具调用”区块。
  • 优化分享图布局,避免工具区、关联用量和底部说明发生重叠。
  • 更新 codex-daily-token-usage 的市场索引 checksum。

为什么有价值

之前插件能告诉用户“消耗了多少 Token”,但很难解释“为什么会消耗这些 Token”。对于真实工作场景来说,这个区别很重要:

  • 一天 Token 很高,可能是因为长上下文讨论;
  • 也可能是因为大量命令执行、文件读取、MCP 或插件调用;
  • 这两种情况代表的工作方式、成本解释和复盘结论都不一样。

新增的工具调用率、调用密度和 Top 工具,可以让用户更容易理解自己的 Codex 使用模式,也让分享图从“数字截图”变成更有解释力的用量报告。

说明和边界

  • DOM 兜底当前主要覆盖可见的 Codex shell 工具卡片,例如 exec_command
  • MCP 和插件调用会在前端暴露 mcp-request/tools/callmcp__server__tool 这类函数名时被统计。
  • 关联用量只在工具事件能可靠匹配到 Token turn 时展示;如果没有可靠关联键,界面会明确显示待关联,不会编造数据。
  • 成本仍然基于用户本地配置的 Model 价格估算,不代表官方账单。

验证

  • jq empty index.json
  • node --check scripts/codex-daily-token-usage.js
  • node --check outputs/codex-daily-token-usage.js
  • CODEX_DAILY_TOKEN_USAGE_SCRIPT=scripts/codex-daily-token-usage.js node ../test-codex-daily-token-usage.js
  • node work/test-codex-daily-token-usage.js
  • git diff --check
  • 已热注入本地 Codex App,验证详情页工具指标展示正常。
  • 已通过 createShareBlob() 生成分享图,并目视检查最终布局无明显错位和重叠。

@kts-kris kts-kris marked this pull request as ready for review July 7, 2026 07:37
@kts-kris kts-kris force-pushed the feat/daily-token-usage-tool-insights branch from 5463f25 to cf402d5 Compare July 7, 2026 07:46
@kts-kris kts-kris changed the title feat: enhance daily token usage tool insights feat: 增强每日用量工具洞察 Jul 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant